MacWorld 2003 August/MW 8 2003 CD1.iso/Inside Macworld/Product News/gimp-1.2.4.sit/gimp-1.2.4/devel-docs/libgimp/sgml/gimptools.sgml

Text File | 2003-05-20 | 89.4 KB | 1,660 lines

<refentry id="libgimp-gimptools" revision="19 Jan 2001">
<refmeta>
<refentrytitle>gimptools</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGIMP Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gimptools</refname><refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>



<link linkend="gboolean">gboolean</link>    <link linkend="gimp-airbrush">gimp_airbrush</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-airbrush-default">gimp_airbrush_default</link>           (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-blend">gimp_blend</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpBlendMode">GimpBlendMode</link> blend_mode,
                                             <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
                                             <link linkend="GimpGradientType">GimpGradientType</link> gradient_type,
                                             <link linkend="gdouble">gdouble</link> opacity,
                                             <link linkend="gdouble">gdouble</link> offset,
                                             <link linkend="GimpRepeatMode">GimpRepeatMode</link> repeat,
                                             <link linkend="gboolean">gboolean</link> supersample,
                                             <link linkend="gint">gint</link> max_depth,
                                             <link linkend="gdouble">gdouble</link> threshold,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1,
                                             <link linkend="gdouble">gdouble</link> x2,
                                             <link linkend="gdouble">gdouble</link> y2);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-bucket-fill">gimp_bucket_fill</link>                (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpBucketFillMode">GimpBucketFillMode</link> fill_mode,
                                             <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
                                             <link linkend="gdouble">gdouble</link> opacity,
                                             <link linkend="gdouble">gdouble</link> threshold,
                                             <link linkend="gboolean">gboolean</link> sample_merged,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-by-color-select">gimp_by_color_select</link>            (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="guchar">guchar</link> red,
                                             <link linkend="guchar">guchar</link> green,
                                             <link linkend="guchar">guchar</link> blue,
                                             <link linkend="gint">gint</link> threshold,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius,
                                             <link linkend="gboolean">gboolean</link> sample_merged);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-clone">gimp_clone</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint32">gint32</link> src_drawable_ID,
                                             <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
                                             <link linkend="gdouble">gdouble</link> src_x,
                                             <link linkend="gdouble">gdouble</link> src_y,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-clone-default">gimp_clone_default</link>              (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-color-picker">gimp_color_picker</link>               (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gboolean">gboolean</link> sample_merged,
                                             <link linkend="gboolean">gboolean</link> sample_average,
                                             <link linkend="gdouble">gdouble</link> average_radius,
                                             <link linkend="gboolean">gboolean</link> save_color,
                                             <link linkend="guchar">guchar</link> *red,
                                             <link linkend="guchar">guchar</link> *green,
                                             <link linkend="guchar">guchar</link> *blue);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-convolve">gimp_convolve</link>                   (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-convolve-default">gimp_convolve_default</link>           (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-crop">gimp_crop</link>                       (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint">gint</link> new_width,
                                             <link linkend="gint">gint</link> new_height,
                                             <link linkend="gint">gint</link> offx,
                                             <link linkend="gint">gint</link> offy);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-dodgeburn">gimp_dodgeburn</link>                  (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> exposure,
                                             <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
                                             <link linkend="GimpDodgeBurnMode">GimpDodgeBurnMode</link> dodgeburn_mode,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-dodgeburn-default">gimp_dodgeburn_default</link>          (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-ellipse-select">gimp_ellipse_select</link>             (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gdouble">gdouble</link> width,
                                             <link linkend="gdouble">gdouble</link> height,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-eraser">gimp_eraser</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes,
                                             <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-eraser-default">gimp_eraser_default</link>             (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gint32">gint32</link>      <link linkend="gimp-flip">gimp_flip</link>                       (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-free-select">gimp_free_select</link>                (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint">gint</link> num_segs,
                                             <link linkend="gdouble">gdouble</link> *segs,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-fuzzy-select">gimp_fuzzy_select</link>               (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gint">gint</link> threshold,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius,
                                             <link linkend="gboolean">gboolean</link> sample_merged);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-paintbrush">gimp_paintbrush</link>                 (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> fade_out,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes,
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
                                             <link linkend="gdouble">gdouble</link> gradient_length);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-paintbrush-default">gimp_paintbrush_default</link>         (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-pencil">gimp_pencil</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gint32">gint32</link>      <link linkend="gimp-perspective">gimp_perspective</link>                (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> x0,
                                             <link linkend="gdouble">gdouble</link> y0,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1,
                                             <link linkend="gdouble">gdouble</link> x2,
                                             <link linkend="gdouble">gdouble</link> y2,
                                             <link linkend="gdouble">gdouble</link> x3,
                                             <link linkend="gdouble">gdouble</link> y3);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-rect-select">gimp_rect_select</link>                (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gdouble">gdouble</link> width,
                                             <link linkend="gdouble">gdouble</link> height,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);
<link linkend="gint32">gint32</link>      <link linkend="gimp-rotate">gimp_rotate</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> angle);
<link linkend="gint32">gint32</link>      <link linkend="gimp-scale">gimp_scale</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> x0,
                                             <link linkend="gdouble">gdouble</link> y0,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1);
<link linkend="gint32">gint32</link>      <link linkend="gimp-shear">gimp_shear</link>                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
                                             <link linkend="gdouble">gdouble</link> magnitude);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-smudge">gimp_smudge</link>                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gboolean">gboolean</link>    <link linkend="gimp-smudge-default">gimp_smudge_default</link>             (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);
<link linkend="gint32">gint32</link>      <link linkend="gimp-transform-2d">gimp_transform_2d</link>               (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> source_x,
                                             <link linkend="gdouble">gdouble</link> source_y,
                                             <link linkend="gdouble">gdouble</link> scale_x,
                                             <link linkend="gdouble">gdouble</link> scale_y,
                                             <link linkend="gdouble">gdouble</link> angle,
                                             <link linkend="gdouble">gdouble</link> dest_x,
                                             <link linkend="gdouble">gdouble</link> dest_y);
</synopsis>
</refsynopsisdiv>





<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="gimp-airbrush">gimp_airbrush ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_airbrush                   (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Paint in the current brush with varying pressure. Paint application
is time-dependent.
</para>
<para>
This tool simulates the use of an airbrush. Paint pressure
represents the relative intensity of the paint application. High
pressure results in a thicker layer of paint while low pressure
results in a thinner layer.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>pressure</parameter> :</entry>
<entry> The pressure of the airbrush strokes.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-airbrush-default">gimp_airbrush_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_airbrush_default           (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Paint in the current brush with varying pressure. Paint application
is time-dependent.
</para>
<para>
This tool simulates the use of an airbrush. It is similar to
gimp_airbrush except that the pressure is derived from the airbrush
tools options box. It the option has not been set the default for
the option will be used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-blend">gimp_blend ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_blend                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpBlendMode">GimpBlendMode</link> blend_mode,
                                             <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
                                             <link linkend="GimpGradientType">GimpGradientType</link> gradient_type,
                                             <link linkend="gdouble">gdouble</link> opacity,
                                             <link linkend="gdouble">gdouble</link> offset,
                                             <link linkend="GimpRepeatMode">GimpRepeatMode</link> repeat,
                                             <link linkend="gboolean">gboolean</link> supersample,
                                             <link linkend="gint">gint</link> max_depth,
                                             <link linkend="gdouble">gdouble</link> threshold,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1,
                                             <link linkend="gdouble">gdouble</link> x2,
                                             <link linkend="gdouble">gdouble</link> y2);</programlisting>
<para>
Blend between the starting and ending coordinates with the specified
blend mode and gradient type.
</para>
<para>
This tool requires information on the paint application mode, the
blend mode, and the gradient type. It creates the specified variety
of blend using the starting and ending coordinates as defined for
each gradient type.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>blend_mode</parameter> :</entry>
<entry> The type of blend.
</entry></row>
<row><entry align="right"><parameter>paint_mode</parameter> :</entry>
<entry> The paint application mode.
</entry></row>
<row><entry align="right"><parameter>gradient_type</parameter> :</entry>
<entry> The type of gradient.
</entry></row>
<row><entry align="right"><parameter>opacity</parameter> :</entry>
<entry> The opacity of the final blend.
</entry></row>
<row><entry align="right"><parameter>offset</parameter> :</entry>
<entry> Offset relates to the starting and ending coordinates specified for the blend. This parameter is mode dependent.
</entry></row>
<row><entry align="right"><parameter>repeat</parameter> :</entry>
<entry> Repeat mode.
</entry></row>
<row><entry align="right"><parameter>supersample</parameter> :</entry>
<entry> Do adaptive supersampling.
</entry></row>
<row><entry align="right"><parameter>max_depth</parameter> :</entry>
<entry> Maximum recursion levels for supersampling.
</entry></row>
<row><entry align="right"><parameter>threshold</parameter> :</entry>
<entry> Supersampling threshold.
</entry></row>
<row><entry align="right"><parameter>x1</parameter> :</entry>
<entry> The x coordinate of this blend's starting point.
</entry></row>
<row><entry align="right"><parameter>y1</parameter> :</entry>
<entry> The y coordinate of this blend's starting point.
</entry></row>
<row><entry align="right"><parameter>x2</parameter> :</entry>
<entry> The x coordinate of this blend's ending point.
</entry></row>
<row><entry align="right"><parameter>y2</parameter> :</entry>
<entry> The y coordinate of this blend's ending point.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-bucket-fill">gimp_bucket_fill ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_bucket_fill                (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpBucketFillMode">GimpBucketFillMode</link> fill_mode,
                                             <link linkend="GimpLayerModeEffects">GimpLayerModeEffects</link> paint_mode,
                                             <link linkend="gdouble">gdouble</link> opacity,
                                             <link linkend="gdouble">gdouble</link> threshold,
                                             <link linkend="gboolean">gboolean</link> sample_merged,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y);</programlisting>
<para>
Fill the area specified either by the current selection if there is
one, or by a seed fill starting at the specified coordinates.
</para>
<para>
This tool requires information on the paint application mode, and
the fill mode, which can either be in the foreground color, or in
the currently active pattern. If there is no selection, a seed fill
is executed at the specified coordinates and extends outward in
keeping with the threshold parameter. If there is a selection in the
target image, the threshold, sample merged, x, and y arguments are
unused. If the sample_merged parameter is non-zero, the data of the
composite image will be used instead of that for the specified
drawable. This is equivalent to sampling for colors after merging
all visible layers. In the case of merged sampling, the x,y
coordinates are relative to the image's origin; otherwise, they are
relative to the drawable's origin.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>fill_mode</parameter> :</entry>
<entry> The type of fill.
</entry></row>
<row><entry align="right"><parameter>paint_mode</parameter> :</entry>
<entry> The paint application mode.
</entry></row>
<row><entry align="right"><parameter>opacity</parameter> :</entry>
<entry> The opacity of the final bucket fill.
</entry></row>
<row><entry align="right"><parameter>threshold</parameter> :</entry>
<entry> The threshold determines how extensive the seed fill will be. It's value is specified in terms of intensity levels . This parameter is only valid when there is no selection in the specified image.
</entry></row>
<row><entry align="right"><parameter>sample_merged</parameter> :</entry>
<entry> Use the composite image, not the drawable.
</entry></row>
<row><entry align="right"><parameter>x</parameter> :</entry>
<entry> The x coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.
</entry></row>
<row><entry align="right"><parameter>y</parameter> :</entry>
<entry> The y coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-by-color-select">gimp_by_color_select ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_by_color_select            (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="guchar">guchar</link> red,
                                             <link linkend="guchar">guchar</link> green,
                                             <link linkend="guchar">guchar</link> blue,
                                             <link linkend="gint">gint</link> threshold,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius,
                                             <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
<para>
Create a selection by selecting all pixels (in the specified
drawable) with the same (or similar) color to that specified.
</para>
<para>
This tool creates a selection over the specified image. A by-color
selection is determined by the supplied color under the constraints
of the specified threshold. Essentially, all pixels (in the
drawable) that have color sufficiently close to the specified color
(as determined by the threshold value) are included in the
selection. The antialiasing parameter allows the final selection
mask to contain intermediate values based on close misses to the
threshold bar. Feathering can be enabled optionally and is
controlled with the \"feather_radius\" parameter. If the
sample_merged parameter is non-zero, the data of the composite image
will be used instead of that for the specified drawable. This is
equivalent to sampling for colors after merging all visible layers.
In the case of a merged sampling, the supplied drawable is ignored.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>red</parameter> :</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>green</parameter> :</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>blue</parameter> :</entry>
<entry> The color to select.
</entry></row>
<row><entry align="right"><parameter>threshold</parameter> :</entry>
<entry> Threshold in intensity levels %<literal>desc</literal>%%.
</entry></row>
<row><entry align="right"><parameter>operation</parameter> :</entry>
<entry> The selection operation.
</entry></row>
<row><entry align="right"><parameter>antialias</parameter> :</entry>
<entry> Antialiasing.
</entry></row>
<row><entry align="right"><parameter>feather</parameter> :</entry>
<entry> Feather option for selections.
</entry></row>
<row><entry align="right"><parameter>feather_radius</parameter> :</entry>
<entry> Radius for feather operation.
</entry></row>
<row><entry align="right"><parameter>sample_merged</parameter> :</entry>
<entry> Use the composite image, not the drawable.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-clone">gimp_clone ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_clone                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint32">gint32</link> src_drawable_ID,
                                             <link linkend="GimpCloneType">GimpCloneType</link> clone_type,
                                             <link linkend="gdouble">gdouble</link> src_x,
                                             <link linkend="gdouble">gdouble</link> src_y,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Clone from the source to the dest drawable using the current brush
</para>
<para>
This tool clones (copies) from the source drawable starting at the
specified source coordinates to the dest drawable. If the
\"clone_type\" argument is set to PATTERN-CLONE, then the current
pattern is used as the source and the \"src_drawable\" argument is
ignored. Pattern cloning assumes a tileable pattern and mods the sum
of the src coordinates and subsequent stroke offsets with the width
and height of the pattern. For image cloning, if the sum of the src
coordinates and subsequent stroke offsets exceeds the extents of the
src drawable, then no paint is transferred. The clone tool is
capable of transforming between any image types including
RGB->Indexed--although converting from any type to indexed is
significantly slower.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>src_drawable_ID</parameter> :</entry>
<entry> The source drawable.
</entry></row>
<row><entry align="right"><parameter>clone_type</parameter> :</entry>
<entry> The type of clone.
</entry></row>
<row><entry align="right"><parameter>src_x</parameter> :</entry>
<entry> The x coordinate in the source image.
</entry></row>
<row><entry align="right"><parameter>src_y</parameter> :</entry>
<entry> The y coordinate in the source image.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-clone-default">gimp_clone_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_clone_default              (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Clone from the source to the dest drawable using the current brush
</para>
<para>
This tool clones (copies) from the source drawable starting at the
specified source coordinates to the dest drawable. This function
performs exactly the same as the gimp_clone function except that the
tools arguments are obtained from the clones option dialog. It this
dialog has not been activated then the dialogs default values will
be used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-color-picker">gimp_color_picker ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_color_picker               (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gboolean">gboolean</link> sample_merged,
                                             <link linkend="gboolean">gboolean</link> sample_average,
                                             <link linkend="gdouble">gdouble</link> average_radius,
                                             <link linkend="gboolean">gboolean</link> save_color,
                                             <link linkend="guchar">guchar</link> *red,
                                             <link linkend="guchar">guchar</link> *green,
                                             <link linkend="guchar">guchar</link> *blue);</programlisting>
<para>
Determine the color at the given drawable coordinates
</para>
<para>
This tool determines the color at the specified coordinates. The
returned color is an RGB triplet even for grayscale and indexed
drawables. If the coordinates lie outside of the extents of the
specified drawable, then an error is returned. If the drawable has
an alpha channel, the algorithm examines the alpha value of the
drawable at the coordinates. If the alpha value is completely
transparent (0), then an error is returned. If the sample_merged
parameter is non-zero, the data of the composite image will be used
instead of that for the specified drawable. This is equivalent to
sampling for colors after merging all visible layers. In the case of
a merged sampling, the supplied drawable is ignored.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>image_ID</parameter> :</entry>
<entry> The image.
</entry></row>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>x</parameter> :</entry>
<entry> x coordinate of upper-left corner of rectangle.
</entry></row>
<row><entry align="right"><parameter>y</parameter> :</entry>
<entry> y coordinate of upper-left corner of rectangle.
</entry></row>
<row><entry align="right"><parameter>sample_merged</parameter> :</entry>
<entry> Use the composite image, not the drawable.
</entry></row>
<row><entry align="right"><parameter>sample_average</parameter> :</entry>
<entry> Average the color of all the pixels in a specified radius.
</entry></row>
<row><entry align="right"><parameter>average_radius</parameter> :</entry>
<entry> The radius of pixels to average.
</entry></row>
<row><entry align="right"><parameter>save_color</parameter> :</entry>
<entry> Save the color to the active palette.
</entry></row>
<row><entry align="right"><parameter>red</parameter> :</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>green</parameter> :</entry>
<entry>
</entry></row>
<row><entry align="right"><parameter>blue</parameter> :</entry>
<entry> The return color.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-convolve">gimp_convolve ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_convolve                   (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="GimpConvolveType">GimpConvolveType</link> convolve_type,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Convolve (Blur, Sharpen) using the current brush.
</para>
<para>
This tool convolves the specified drawable with either a sharpening
or blurring kernel. The pressure parameter controls the magnitude of
the operation. Like the paintbrush, this tool linearly interpolates
between the specified stroke coordinates.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>pressure</parameter> :</entry>
<entry> The pressure.
</entry></row>
<row><entry align="right"><parameter>convolve_type</parameter> :</entry>
<entry> Convolve type.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-convolve-default">gimp_convolve_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_convolve_default           (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Convolve (Blur, Sharpen) using the current brush.
</para>
<para>
This tool convolves the specified drawable with either a sharpening
or blurring kernel. This function performs exactly the same as the
gimp_convolve function except that the tools arguments are obtained
from the convolve option dialog. It this dialog has not been
activated then the dialogs default values will be used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-crop">gimp_crop ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_crop                       (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint">gint</link> new_width,
                                             <link linkend="gint">gint</link> new_height,
                                             <link linkend="gint">gint</link> offx,
                                             <link linkend="gint">gint</link> offy);</programlisting>
<para>
Crop the image to the specified extents.
</para>
<para>
This procedure crops the image so that it's new width and height are
equal to the supplied parameters. Offsets are also provided which
describe the position of the previous image's content. All channels
and layers within the image are cropped to the new image extents;
this includes the image selection mask. If any parameters are out of
range, an error is returned.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>image_ID</parameter> :</entry>
<entry> The image.
</entry></row>
<row><entry align="right"><parameter>new_width</parameter> :</entry>
<entry> New image width: (0 < new_width <= width).
</entry></row>
<row><entry align="right"><parameter>new_height</parameter> :</entry>
<entry> New image height: (0 < new_height <= height).
</entry></row>
<row><entry align="right"><parameter>offx</parameter> :</entry>
<entry> x offset: (0 <= offx <= (width - new_width)).
</entry></row>
<row><entry align="right"><parameter>offy</parameter> :</entry>
<entry> y offset: (0 <= offy <= (height - new_height)).
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-dodgeburn">gimp_dodgeburn ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_dodgeburn                  (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> exposure,
                                             <link linkend="GimpDodgeBurnType">GimpDodgeBurnType</link> dodgeburn_type,
                                             <link linkend="GimpDodgeBurnMode">GimpDodgeBurnMode</link> dodgeburn_mode,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Dodgeburn image with varying exposure.
</para>
<para>
Dodgebure. More details here later.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>exposure</parameter> :</entry>
<entry> The exposer of the strokes.
</entry></row>
<row><entry align="right"><parameter>dodgeburn_type</parameter> :</entry>
<entry> The type either dodge or burn.
</entry></row>
<row><entry align="right"><parameter>dodgeburn_mode</parameter> :</entry>
<entry> The mode.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-dodgeburn-default">gimp_dodgeburn_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_dodgeburn_default          (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Dodgeburn image with varying exposure. This is the same as the
gimp_dodgeburn function except that the exposure, type and mode are
taken from the tools option dialog. If the dialog has not been
activated then the defaults as used by the dialog will be used.
</para>
<para>
Dodgebure. More details here later.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-ellipse-select">gimp_ellipse_select ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_ellipse_select             (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gdouble">gdouble</link> width,
                                             <link linkend="gdouble">gdouble</link> height,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
<para>
Create an elliptical selection over the specified image.
</para>
<para>
This tool creates an elliptical selection over the specified image.
The elliptical region can be either added to, subtracted from, or
replace the contents of the previous selection mask. If antialiasing
is turned on, the edges of the elliptical region will contain
intermediate values which give the appearance of a sharper, less
pixelized edge. This should be set as TRUE most of the time. If the
feather option is enabled, the resulting selection is blurred before
combining. The blur is a gaussian blur with the specified feather
radius.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>image_ID</parameter> :</entry>
<entry> The image.
</entry></row>
<row><entry align="right"><parameter>x</parameter> :</entry>
<entry> x coordinate of upper-left corner of ellipse bounding box.
</entry></row>
<row><entry align="right"><parameter>y</parameter> :</entry>
<entry> y coordinate of upper-left corner of ellipse bounding box.
</entry></row>
<row><entry align="right"><parameter>width</parameter> :</entry>
<entry> The width of the ellipse.
</entry></row>
<row><entry align="right"><parameter>height</parameter> :</entry>
<entry> The height of the ellipse.
</entry></row>
<row><entry align="right"><parameter>operation</parameter> :</entry>
<entry> The selection operation.
</entry></row>
<row><entry align="right"><parameter>antialias</parameter> :</entry>
<entry> Antialiasing.
</entry></row>
<row><entry align="right"><parameter>feather</parameter> :</entry>
<entry> Feather option for selections.
</entry></row>
<row><entry align="right"><parameter>feather_radius</parameter> :</entry>
<entry> Radius for feather operation.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-eraser">gimp_eraser ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_eraser                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes,
                                             <link linkend="GimpBrushApplicationMode">GimpBrushApplicationMode</link> hardness,
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method);</programlisting>
<para>
Erase using the current brush.
</para>
<para>
This tool erases using the current brush mask. If the specified
drawable contains an alpha channel, then the erased pixels will
become transparent. Otherwise, the eraser tool replaces the contents
of the drawable with the background color. Like paintbrush, this
tool linearly interpolates between the specified stroke coordinates.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><parameter>hardness</parameter> :</entry>
<entry> %<literal>desc</literal>%%.
</entry></row>
<row><entry align="right"><parameter>method</parameter> :</entry>
<entry> %<literal>desc</literal>%%.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-eraser-default">gimp_eraser_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_eraser_default             (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Erase using the current brush.
</para>
<para>
This tool erases using the current brush mask. This function
performs exactly the same as the gimp_eraser function except that
the tools arguments are obtained from the eraser option dialog. It
this dialog has not been activated then the dialogs default values
will be used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-flip">gimp_flip ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_flip                       (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> flip_type);</programlisting>
<para>
Flip the specified drawable about its center either vertically or
horizontally.
</para>
<para>
This tool flips the specified drawable if no selection exists. If a
selection exists, the portion of the drawable which lies under the
selection is cut from the drawable and made into a floating
selection which is then flipd by the specified amount. The return
value is the ID of the flipped drawable. If there was no selection,
this will be equal to the drawable ID supplied as input. Otherwise,
this will be the newly created and flipped drawable. The flip type
parameter indicates whether the flip will be applied horizontally or
vertically.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>flip_type</parameter> :</entry>
<entry> Type of flip.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The flipped drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-free-select">gimp_free_select ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_free_select                (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gint">gint</link> num_segs,
                                             <link linkend="gdouble">gdouble</link> *segs,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
<para>
Create a polygonal selection over the specified image.
</para>
<para>
This tool creates a polygonal selection over the specified image.
The polygonal region can be either added to, subtracted from, or
replace the contents of the previous selection mask. The polygon is
specified through an array of floating point numbers and its length.
The length of array must be 2n, where n is the number of points.
Each point is defined by 2 floating point values which correspond to
the x and y coordinates. If the final point does not connect to the
starting point, a connecting segment is automatically added. If the
feather option is enabled, the resulting selection is blurred before
combining. The blur is a gaussian blur with the specified feather
radius.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>image_ID</parameter> :</entry>
<entry> The image.
</entry></row>
<row><entry align="right"><parameter>num_segs</parameter> :</entry>
<entry> Number of points (count 1 coordinate as two points).
</entry></row>
<row><entry align="right"><parameter>segs</parameter> :</entry>
<entry> Array of points: { p1.x, p1.y, p2.x, p2.y, ..., pn.x, pn.y}.
</entry></row>
<row><entry align="right"><parameter>operation</parameter> :</entry>
<entry> The selection operation.
</entry></row>
<row><entry align="right"><parameter>antialias</parameter> :</entry>
<entry> Antialiasing.
</entry></row>
<row><entry align="right"><parameter>feather</parameter> :</entry>
<entry> Feather option for selections.
</entry></row>
<row><entry align="right"><parameter>feather_radius</parameter> :</entry>
<entry> Radius for feather operation.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-fuzzy-select">gimp_fuzzy_select ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_fuzzy_select               (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gint">gint</link> threshold,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> antialias,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius,
                                             <link linkend="gboolean">gboolean</link> sample_merged);</programlisting>
<para>
Create a fuzzy selection starting at the specified coordinates on
the specified drawable.
</para>
<para>
This tool creates a fuzzy selection over the specified image. A
fuzzy selection is determined by a seed fill under the constraints
of the specified threshold. Essentially, the color at the specified
coordinates (in the drawable) is measured and the selection expands
outwards from that point to any adjacent pixels which are not
significantly different (as determined by the threshold value). This
process continues until no more expansion is possible. The
antialiasing parameter allows the final selection mask to contain
intermediate values based on close misses to the threshold bar at
pixels along the seed fill boundary. Feathering can be enabled
optionally and is controlled with the \"feather_radius\" paramter.
If the sample_merged parameter is non-zero, the data of the
composite image will be used instead of that for the specified
drawable. This is equivalent to sampling for colors after merging
all visible layers. In the case of a merged sampling, the supplied
drawable is ignored. If the sample is merged, the specified
coordinates are relative to the image origin; otherwise, they are
relative to the drawable's origin.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>x</parameter> :</entry>
<entry> x coordinate of initial seed fill point: (image coordinates).
</entry></row>
<row><entry align="right"><parameter>y</parameter> :</entry>
<entry> y coordinate of initial seed fill point: (image coordinates).
</entry></row>
<row><entry align="right"><parameter>threshold</parameter> :</entry>
<entry> Threshold in intensity levels %<literal>desc</literal>%%.
</entry></row>
<row><entry align="right"><parameter>operation</parameter> :</entry>
<entry> The selection operation.
</entry></row>
<row><entry align="right"><parameter>antialias</parameter> :</entry>
<entry> Antialiasing.
</entry></row>
<row><entry align="right"><parameter>feather</parameter> :</entry>
<entry> Feather option for selections.
</entry></row>
<row><entry align="right"><parameter>feather_radius</parameter> :</entry>
<entry> Radius for feather operation.
</entry></row>
<row><entry align="right"><parameter>sample_merged</parameter> :</entry>
<entry> Use the composite image, not the drawable.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-paintbrush">gimp_paintbrush ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_paintbrush                 (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> fade_out,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes,
                                             <link linkend="GimpPaintApplicationMode">GimpPaintApplicationMode</link> method,
                                             <link linkend="gdouble">gdouble</link> gradient_length);</programlisting>
<para>
Paint in the current brush with optional fade out parameter and pull
colors from a gradient.
</para>
<para>
This tool is the standard paintbrush. It draws linearly interpolated
lines through the specified stroke coordinates. It operates on the
specified drawable in the foreground color with the active brush.
The \"fade_out\" parameter is measured in pixels and allows the
brush stroke to linearly fall off. The pressure is set to the
maximum at the beginning of the stroke. As the distance of the
stroke nears the fade_out value, the pressure will approach zero.
The gradient_length is the distance to spread the gradient over. It
is measured in pixels. If the gradient_length is 0, no gradient is
used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>fade_out</parameter> :</entry>
<entry> Fade out parameter.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><parameter>method</parameter> :</entry>
<entry> %<literal>desc</literal>%%.
</entry></row>
<row><entry align="right"><parameter>gradient_length</parameter> :</entry>
<entry> Length of gradient to draw.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-paintbrush-default">gimp_paintbrush_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_paintbrush_default         (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Paint in the current brush. The fade out parameter and pull colors
from a gradient parameter are set from the paintbrush options
dialog. If this dialog has not been activated then the dialog
defaults will be used.
</para>
<para>
This tool is similar to the standard paintbrush. It draws linearly
interpolated lines through the specified stroke coordinates. It
operates on the specified drawable in the foreground color with the
active brush. The \"fade_out\" parameter is measured in pixels and
allows the brush stroke to linearly fall off (value obtained from
the option dialog). The pressure is set to the maximum at the
beginning of the stroke. As the distance of the stroke nears the
fade_out value, the pressure will approach zero. The gradient_length
(value obtained from the option dialog) is the distance to spread
the gradient over. It is measured in pixels. If the gradient_length
is 0, no gradient is used.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-pencil">gimp_pencil ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_pencil                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Paint in the current brush without sub-pixel sampling.
</para>
<para>
This tool is the standard pencil. It draws linearly interpolated
lines through the specified stroke coordinates. It operates on the
specified drawable in the foreground color with the active brush.
The brush mask is treated as though it contains only black and white
values. Any value below half is treated as black; any above half, as
white.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-perspective">gimp_perspective ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_perspective                (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> x0,
                                             <link linkend="gdouble">gdouble</link> y0,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1,
                                             <link linkend="gdouble">gdouble</link> x2,
                                             <link linkend="gdouble">gdouble</link> y2,
                                             <link linkend="gdouble">gdouble</link> x3,
                                             <link linkend="gdouble">gdouble</link> y3);</programlisting>
<para>
Perform a possibly non-affine transformation on the specified
drawable.
</para>
<para>
This tool performs a possibly non-affine transformation on the
specified drawable by allowing the corners of the original bounding
box to be arbitrarily remapped to any values. The specified drawable
is remapped if no selection exists. However, if a selection exists,
the portion of the drawable which lies under the selection is cut
from the drawable and made into a floating selection which is then
remapped as specified. The interpolation parameter can be set to
TRUE to indicate that either linear or cubic interpolation should be
used to smooth the resulting remapped drawable. The return value is
the ID of the remapped drawable. If there was no selection, this
will be equal to the drawable ID supplied as input. Otherwise, this
will be the newly created and remapped drawable. The 4 coordinates
specify the new locations of each corner of the original bounding
box. By specifying these values, any affine transformation
(rotation, scaling, translation) can be affected. Additionally,
these values can be specified such that the resulting transformed
drawable will appear to have been projected via a perspective
transform.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>interpolation</parameter> :</entry>
<entry> Whether to use interpolation.
</entry></row>
<row><entry align="right"><parameter>x0</parameter> :</entry>
<entry> The new x coordinate of upper-left corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>y0</parameter> :</entry>
<entry> The new y coordinate of upper-left corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>x1</parameter> :</entry>
<entry> The new x coordinate of upper-right corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>y1</parameter> :</entry>
<entry> The new y coordinate of upper-right corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>x2</parameter> :</entry>
<entry> The new x coordinate of lower-left corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>y2</parameter> :</entry>
<entry> The new y coordinate of lower-left corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>x3</parameter> :</entry>
<entry> The new x coordinate of lower-right corner of original bounding box.
</entry></row>
<row><entry align="right"><parameter>y3</parameter> :</entry>
<entry> The new y coordinate of lower-right corner of original bounding box.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The newly mapped drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-rect-select">gimp_rect_select ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_rect_select                (<link linkend="gint32">gint32</link> image_ID,
                                             <link linkend="gdouble">gdouble</link> x,
                                             <link linkend="gdouble">gdouble</link> y,
                                             <link linkend="gdouble">gdouble</link> width,
                                             <link linkend="gdouble">gdouble</link> height,
                                             <link linkend="GimpChannelOps">GimpChannelOps</link> operation,
                                             <link linkend="gboolean">gboolean</link> feather,
                                             <link linkend="gdouble">gdouble</link> feather_radius);</programlisting>
<para>
Create a rectangular selection over the specified image;
</para>
<para>
This tool creates a rectangular selection over the specified image.
The rectangular region can be either added to, subtracted from, or
replace the contents of the previous selection mask. If the feather
option is enabled, the resulting selection is blurred before
combining. The blur is a gaussian blur with the specified feather
radius.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>image_ID</parameter> :</entry>
<entry> The image.
</entry></row>
<row><entry align="right"><parameter>x</parameter> :</entry>
<entry> x coordinate of upper-left corner of rectangle.
</entry></row>
<row><entry align="right"><parameter>y</parameter> :</entry>
<entry> y coordinate of upper-left corner of rectangle.
</entry></row>
<row><entry align="right"><parameter>width</parameter> :</entry>
<entry> The width of the rectangle.
</entry></row>
<row><entry align="right"><parameter>height</parameter> :</entry>
<entry> The height of the rectangle.
</entry></row>
<row><entry align="right"><parameter>operation</parameter> :</entry>
<entry> The selection operation.
</entry></row>
<row><entry align="right"><parameter>feather</parameter> :</entry>
<entry> Feather option for selections.
</entry></row>
<row><entry align="right"><parameter>feather_radius</parameter> :</entry>
<entry> Radius for feather operation.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-rotate">gimp_rotate ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_rotate                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> angle);</programlisting>
<para>
Rotate the specified drawable about its center through the specified
angle.
</para>
<para>
This tool rotates the specified drawable if no selection exists. If
a selection exists, the portion of the drawable which lies under the
selection is cut from the drawable and made into a floating
selection which is then rotated by the specified amount. The
interpolation parameter can be set to TRUE to indicate that either
linear or cubic interpolation should be used to smooth the resulting
rotated drawable. The return value is the ID of the rotated
drawable. If there was no selection, this will be equal to the
drawable ID supplied as input. Otherwise, this will be the newly
created and rotated drawable.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>interpolation</parameter> :</entry>
<entry> Whether to use interpolation.
</entry></row>
<row><entry align="right"><parameter>angle</parameter> :</entry>
<entry> The angle of rotation (radians).
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The rotated drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-scale">gimp_scale ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_scale                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> x0,
                                             <link linkend="gdouble">gdouble</link> y0,
                                             <link linkend="gdouble">gdouble</link> x1,
                                             <link linkend="gdouble">gdouble</link> y1);</programlisting>
<para>
Scale the specified drawable.
</para>
<para>
This tool scales the specified drawable if no selection exists. If a
selection exists, the portion of the drawable which lies under the
selection is cut from the drawable and made into a floating
selection which is then scaled by the specified amount. The
interpolation parameter can be set to TRUE to indicate that either
linear or cubic interpolation should be used to smooth the resulting
scaled drawable. The return value is the ID of the scaled drawable.
If there was no selection, this will be equal to the drawable ID
supplied as input. Otherwise, this will be the newly created and
scaled drawable.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>interpolation</parameter> :</entry>
<entry> Whether to use interpolation.
</entry></row>
<row><entry align="right"><parameter>x0</parameter> :</entry>
<entry> The new x coordinate of upper-left corner of newly scaled region.
</entry></row>
<row><entry align="right"><parameter>y0</parameter> :</entry>
<entry> The new y coordinate of upper-left corner of newly scaled region.
</entry></row>
<row><entry align="right"><parameter>x1</parameter> :</entry>
<entry> The new x coordinate of lower-right corner of newly scaled region.
</entry></row>
<row><entry align="right"><parameter>y1</parameter> :</entry>
<entry> The new y coordinate of lower-right corner of newly scaled region.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The scaled drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-shear">gimp_shear ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_shear                      (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="GimpOrientationType">GimpOrientationType</link> shear_type,
                                             <link linkend="gdouble">gdouble</link> magnitude);</programlisting>
<para>
Shear the specified drawable about its center by the specified
magnitude.
</para>
<para>
This tool shears the specified drawable if no selection exists. If a
selection exists, the portion of the drawable which lies under the
selection is cut from the drawable and made into a floating
selection which is then sheard by the specified amount. The
interpolation parameter can be set to TRUE to indicate that either
linear or cubic interpolation should be used to smooth the resulting
sheared drawable. The return value is the ID of the sheard drawable.
If there was no selection, this will be equal to the drawable ID
supplied as input. Otherwise, this will be the newly created and
sheard drawable. The shear type parameter indicates whether the
shear will be applied horizontally or vertically. The magnitude can
be either positive or negative and indicates the extent (in pixels)
to shear by.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>interpolation</parameter> :</entry>
<entry> Whether to use interpolation.
</entry></row>
<row><entry align="right"><parameter>shear_type</parameter> :</entry>
<entry> Type of shear.
</entry></row>
<row><entry align="right"><parameter>magnitude</parameter> :</entry>
<entry> The magnitude of the shear.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The sheared drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-smudge">gimp_smudge ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_smudge                     (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gdouble">gdouble</link> pressure,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Smudge image with varying pressure.
</para>
<para>
This tool simulates a smudge using the current brush. High pressure
results in a greater smudge of paint while low pressure results in a
lesser smudge.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>pressure</parameter> :</entry>
<entry> The pressure of the smudge strokes.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-smudge-default">gimp_smudge_default ()</title>
<programlisting><link linkend="gboolean">gboolean</link>    gimp_smudge_default             (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gint">gint</link> num_strokes,
                                             <link linkend="gdouble">gdouble</link> *strokes);</programlisting>
<para>
Smudge image with varying pressure.
</para>
<para>
This tool simulates a smudge using the current brush. It behaves
exactly the same as gimp_smudge except that the pressure value is
taken from the smudge tool options or the options default if the
tools option dialog has not been activated.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>num_strokes</parameter> :</entry>
<entry> Number of stroke control points (count each coordinate as 2 points).
</entry></row>
<row><entry align="right"><parameter>strokes</parameter> :</entry>
<entry> Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> TRUE on success.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gimp-transform-2d">gimp_transform_2d ()</title>
<programlisting><link linkend="gint32">gint32</link>      gimp_transform_2d               (<link linkend="gint32">gint32</link> drawable_ID,
                                             <link linkend="gboolean">gboolean</link> interpolation,
                                             <link linkend="gdouble">gdouble</link> source_x,
                                             <link linkend="gdouble">gdouble</link> source_y,
                                             <link linkend="gdouble">gdouble</link> scale_x,
                                             <link linkend="gdouble">gdouble</link> scale_y,
                                             <link linkend="gdouble">gdouble</link> angle,
                                             <link linkend="gdouble">gdouble</link> dest_x,
                                             <link linkend="gdouble">gdouble</link> dest_y);</programlisting>
<para>
Transform the specified drawable in 2d.
</para>
<para>
This tool transforms the specified drawable if no selection exists.
If a selection exists, the portion of the drawable which lies under
the selection is cut from the drawable and made into a floating
selection which is then transformed. The interpolation parameter can
be set to TRUE to indicate that either linear or cubic interpolation
should be used to smooth the resulting drawable. The transformation
is done by scaling the image by the x and y scale factors about the
point (source_x, source_y), then rotating around the same point,
then translating that point to the new position (dest_x, dest_y).
The return value is the ID of the rotated drawable. If there was no
selection, this will be equal to the drawable ID supplied as input.
Otherwise, this will be the newly created and transformed drawable.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>drawable_ID</parameter> :</entry>
<entry> The affected drawable.
</entry></row>
<row><entry align="right"><parameter>interpolation</parameter> :</entry>
<entry> Whether to use interpolation.
</entry></row>
<row><entry align="right"><parameter>source_x</parameter> :</entry>
<entry> X coordinate of the transformation center.
</entry></row>
<row><entry align="right"><parameter>source_y</parameter> :</entry>
<entry> Y coordinate of the transformation center.
</entry></row>
<row><entry align="right"><parameter>scale_x</parameter> :</entry>
<entry> Amount to scale in x direction.
</entry></row>
<row><entry align="right"><parameter>scale_y</parameter> :</entry>
<entry> Amount to scale in y direction.
</entry></row>
<row><entry align="right"><parameter>angle</parameter> :</entry>
<entry> The angle of rotation (radians).
</entry></row>
<row><entry align="right"><parameter>dest_x</parameter> :</entry>
<entry> X coordinate of where the centre goes.
</entry></row>
<row><entry align="right"><parameter>dest_y</parameter> :</entry>
<entry> Y coordinate of where the centre goes.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> The transformed drawable.
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>